package com.cencat.user.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.cencat.common.enums.UserStatus;
import com.cencat.common.exception.BusinessException;
import com.cencat.user.dto.UserCreateDTO;
import com.cencat.user.dto.UserUpdateDTO;
import com.cencat.user.dto.UserQueryDTO;
import com.cencat.user.dto.LoginDTO;
import com.cencat.user.dto.TokenDTO;
import com.cencat.user.dto.LogoutDTO;
import com.cencat.user.entity.User;
import com.cencat.user.vo.UserVO;
import com.cencat.user.vo.UserListVO;
import com.cencat.user.vo.LoginVO;
import com.cencat.user.vo.TokenVO;

import java.util.List;

/**
 * 用户服务接口
 * @author cencat
 * @since 2024-01-01
 */
public interface UserService {

    /**
     * 创建用户
     * @param dto 用户创建DTO
     * @return 用户ID
     * @throws BusinessException 业务异常
     */
    Long createUser(UserCreateDTO dto) throws BusinessException;

    /**
     * 更新用户
     * @param dto 用户更新DTO
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean updateUser(UserUpdateDTO dto) throws BusinessException;

    /**
     * 删除用户（逻辑删除）
     * @param userId 用户ID
     * @param tenantId 租户ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean deleteUser(Long userId, Long tenantId) throws BusinessException;

    /**
     * 批量删除用户（逻辑删除）
     * @param userIds 用户ID列表
     * @param tenantId 租户ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean batchDeleteUsers(List<Long> userIds, Long tenantId) throws BusinessException;

    /**
     * 根据ID查询用户详情
     * @param userId 用户ID
     * @param tenantId 租户ID
     * @return 用户详情
     * @throws BusinessException 业务异常
     */
    UserVO getUserById(Long userId, Long tenantId) throws BusinessException;

    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @param tenantId 租户ID
     * @return 用户信息
     * @throws BusinessException 业务异常
     */
    User getUserByUsername(String username, Long tenantId) throws BusinessException;

    /**
     * 根据邮箱查询用户
     * @param email 邮箱
     * @param tenantId 租户ID
     * @return 用户信息
     * @throws BusinessException 业务异常
     */
    User getUserByEmail(String email, Long tenantId) throws BusinessException;

    /**
     * 根据手机号查询用户
     * @param phone 手机号
     * @param tenantId 租户ID
     * @return 用户信息
     * @throws BusinessException 业务异常
     */
    User getUserByPhone(String phone, Long tenantId) throws BusinessException;

    /**
     * 分页查询用户列表
     * @param queryDTO 查询条件
     * @return 用户分页列表
     * @throws BusinessException 业务异常
     */
    IPage<UserListVO> getUserPage(UserQueryDTO queryDTO) throws BusinessException;

    /**
     * 查询用户列表
     * @param queryDTO 查询条件
     * @return 用户列表
     * @throws BusinessException 业务异常
     */
    List<UserListVO> getUserList(UserQueryDTO queryDTO) throws BusinessException;

    /**
     * 启用用户
     * @param userId 用户ID
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean enableUser(Long userId, Long tenantId, Long operatorId) throws BusinessException;

    /**
     * 禁用用户
     * @param userId 用户ID
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean disableUser(Long userId, Long tenantId, Long operatorId) throws BusinessException;

    /**
     * 批量更新用户状态
     * @param userIds 用户ID列表
     * @param status 用户状态
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean batchUpdateUserStatus(List<Long> userIds, UserStatus status, Long tenantId, Long operatorId) throws BusinessException;

    /**
     * 重置用户密码
     * @param userId 用户ID
     * @param newPassword 新密码
     * @param tenantId 租户ID
     * @param operatorId 操作人ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean resetPassword(Long userId, String newPassword, Long tenantId, Long operatorId) throws BusinessException;

    /**
     * 修改密码
     * @param userId 用户ID
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @param tenantId 租户ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean changePassword(Long userId, String oldPassword, String newPassword, Long tenantId) throws BusinessException;

    /**
     * 用户登录
     * @param dto 登录DTO
     * @return 登录结果
     * @throws BusinessException 业务异常
     */
    LoginVO login(LoginDTO dto) throws BusinessException;

    /**
     * 用户登出
     * @param dto 登出DTO
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean logout(LogoutDTO dto) throws BusinessException;

    /**
     * 刷新访问令牌
     * @param dto 令牌DTO
     * @return 新的令牌信息
     * @throws BusinessException 业务异常
     */
    TokenVO refreshToken(TokenDTO dto) throws BusinessException;

    /**
     * 验证访问令牌
     * @param accessToken 访问令牌
     * @param tenantId 租户ID
     * @return 是否有效
     * @throws BusinessException 业务异常
     */
    Boolean validateToken(String accessToken, Long tenantId) throws BusinessException;

    /**
     * 用户登录（兼容旧版本）
     * @param username 用户名
     * @param password 密码
     * @param loginIp 登录IP
     * @param tenantId 租户ID
     * @return 用户信息
     * @throws BusinessException 业务异常
     * @deprecated 请使用 login(LoginDTO dto) 方法
     */
    @Deprecated
    UserVO loginLegacy(String username, String password, String loginIp, Long tenantId) throws BusinessException;

    /**
     * 用户登出（兼容旧版本）
     * @param userId 用户ID
     * @param tenantId 租户ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     * @deprecated 请使用 logout(LogoutDTO dto) 方法
     */
    @Deprecated
    Boolean logoutLegacy(Long userId, Long tenantId) throws BusinessException;

    /**
     * 统计用户数量
     * @param queryDTO 查询条件
     * @return 用户数量
     * @throws BusinessException 业务异常
     */
    Long countUsers(UserQueryDTO queryDTO) throws BusinessException;

    /**
     * 检查用户名是否存在
     * @param username 用户名
     * @param excludeUserId 排除的用户ID
     * @param tenantId 租户ID
     * @return 是否存在
     * @throws BusinessException 业务异常
     */
    Boolean checkUsernameExists(String username, Long excludeUserId, Long tenantId) throws BusinessException;

    /**
     * 检查邮箱是否存在
     * @param email 邮箱
     * @param excludeUserId 排除的用户ID
     * @param tenantId 租户ID
     * @return 是否存在
     * @throws BusinessException 业务异常
     */
    Boolean checkEmailExists(String email, Long excludeUserId, Long tenantId) throws BusinessException;

    /**
     * 检查手机号是否存在
     * @param phone 手机号
     * @param excludeUserId 排除的用户ID
     * @param tenantId 租户ID
     * @return 是否存在
     * @throws BusinessException 业务异常
     */
    Boolean checkPhoneExists(String phone, Long excludeUserId, Long tenantId) throws BusinessException;

    /**
     * 根据租户ID查询用户列表
     * @param tenantId 租户ID
     * @return 用户列表
     * @throws BusinessException 业务异常
     */
    List<User> getUsersByTenantId(Long tenantId) throws BusinessException;

    /**
     * 更新最后登录信息
     * @param userId 用户ID
     * @param loginIp 登录IP
     * @param tenantId 租户ID
     * @return 是否成功
     * @throws BusinessException 业务异常
     */
    Boolean updateLastLoginInfo(Long userId, String loginIp, Long tenantId) throws BusinessException;
}